Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Finder Dialog Box Messages

GXWriteStatusToDTPWindow

The Finder sends the GXWriteStatusToDTPWindow message when it receives the status from a background printing process and wants to display that status in the the user's desktop printer window. You can override the GXWriteStatusToDTPWindow message to determine if you want to handle a specific status message. Your override of the WriteStatusToDTPWIndow message must match the following formal declaration:

OSErr MyWriteStatusToDTPWindow (gxStatusRecord aStatusRecord, 
                                 gxDisplayRecord aDisplayRecord);

aStatusRecord

A pointer to the status structure.

aDisplayRecord

On return, a pointer to the information to be displayed.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of this message turns the status structure into a string using the status ('stat') resource supplied by the driver.

Your override of the GXWriteStatusToDTPWindow message needs to examine the statusOwner field in the status structure to determine if you need to handle the status. If your override needs to display status information that is more complex than is supported by this standard status handling, you must fill in this structure yourself. If the statusOwner field in the status structure does not match your driver's signature, you must forward this message.

SPECIAL CONSIDERATIONS

You never send the GXWriteStatusToDTPWindow message yourself.

If you do handle the status, you need to perform a total override of the GXWriteStatusToDTPWindow message. Otherwise, you must forward the GXWriteStatusToDTPWindow message so that another handler can respond to it.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The status structure is described on page 4-39, and the status resource is described on page 6-19 in the chapter "Printing Resources."

The display structure is described on page 4-41.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help